package cc.comac.saic.hkhy.jsrj.gj.inttools.service;

import java.util.Collection;
import java.util.List;

import org.springframework.web.bind.annotation.PathVariable;

import cc.comac.saic.hkhy.jsrj.gj.inttools.constant.FileType;
import cc.comac.saic.hkhy.jsrj.gj.inttools.pojo.entity.FileInfo;
import cc.comac.saic.hkhy.jsrj.gj.inttools.pojo.vo.FileInfoSearchVo;
import cc.comac.saic.hkhy.jsrj.gj.inttools.pojo.vo.FileInfoShowVo;
import cc.comac.saic.hkhy.jsrj.gj.inttools.pojo.vo.FileTypeStatVo;
import jakarta.servlet.http.Part;

/**
 * 文件信息(FileInfo)表服务接口
 *
 * @author makejava
 * @since 2025-07-02 18:26:30
 */
public interface FileInfoService {

    /**
     * 通过ID查询单条数据
     *
     * @param id 主键
     * @return 实例对象
     */
    FileInfo queryById(Long id);

    List<FileInfoShowVo> queryVersionByDataKey(String key);

    /**
     * 分页查询
     *
     * @param fileInfo 筛选条件
     * @return 查询结果
     */
    List<FileInfo> queryByCondition(FileInfoSearchVo fileInfo);
    List<FileInfo> queryProjectFile(String projKey, String fileType);

    /**
     * 新增数据
     *
     * @param fileInfo 实例对象
     * @return 实例对象
     */
    FileInfo insert(FileInfo fileInfo);

    /**
     * 修改数据
     *
     * @param fileInfo 实例对象
     * @return 实例对象
     */
    FileInfo update(FileInfo fileInfo);

    /**
     * 通过主键删除数据
     *
     * @param id 主键
     * @return 是否成功
     */
    boolean deleteById(Long id);

    List<FileInfoShowVo> upload(String projKey, FileType fileType, Collection<Part> fileParts ,Long operator);

    /**
     * 获取文件内容，通过字符串类型返回
     *
     * @param projKey     项目标识
     * @param fileType    文件类型 @see cc.comac.saic.hkhy.jsrj.gj.inttools.constant.FileType
     * @param filePath    文件路径
     * @param versionHash 版本hash
     * @return 文件byte[]
     */
    byte[] download(String projKey, String fileType, String filePath, String versionHash);

    /**
     * 获取文件内容，通过字符串类型返回（最新版）
     *
     * @param fileId 文件id
     * @return 文件byte[]
     */
    byte[] downloadByFileId(Long fileId);

    /**
     * 获取文件内容，通过字符串类型返回
     *
     * @param fileVersionId 文件版本id
     * @return 文件byte[]
     */
    byte[] downloadByFileVersionId(Long fileVersionId);

    /**
     * 获取文件内容，通过字符串类型返回
     *
     * @param projKey     项目标识
     * @param fileType    文件类型 @see cc.comac.saic.hkhy.jsrj.gj.inttools.constant.FileType
     * @param filePath    文件路径
     * @param versionHash 版本hash
     * @return 文件内容
     */
    String getContent(String projKey, String fileType, String filePath, String versionHash);

    /**
     * 获取文件内容，通过字符串类型返回（最新版）
     *
     * @param fileId 文件id
     * @return 文件内容
     */
    String getContentByFileId(Long fileId);

    /**
     * 获取文件内容，通过字符串类型返回
     *
     * @param fileVersionId 文件版本id
     * @return 文件内容
     */
    String getContentByFileVersionId(Long fileVersionId);

    /**
     * 统计某项目下各文件类型数量
     *
     * @param projId 项目ID
     * @return 文件类型统计列表
     */
    List<FileTypeStatVo> getFileTypeStatsByProjectId(Long projId);
}
